package com.ilink.groundservice.service.Literature;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.ilink.groundservice.entity.VO.AiX.AiXLiteratureResponse;
import com.ilink.ilinkapi.dto.ground.AiX.AiXLiteratureFilterRequest;
import com.ilink.ilinkapi.dto.ground.AiX.AiXLiteratureInsertRequest;
import com.ilink.ilinkapi.dto.ground.AiX.AiXLiteratureUpdateRequest;
import com.ilink.ilinkcommon.domain.R;
import org.springframework.web.multipart.MultipartFile;

import java.util.List;

public interface AiXLiteratureService {

    /**
     * 分页查询文献列表
     */
    IPage<AiXLiteratureResponse> getLiteratureList(AiXLiteratureFilterRequest request, String userId);

    /**
     * 根据ID获取文献详情
     */
    AiXLiteratureResponse getLiteratureById(Long literatureId, String userId);

    /**
     * 插入文献
     */
    Long insertLiterature(AiXLiteratureInsertRequest request);

    /**
     * 更新文献
     */
    void updateLiterature(AiXLiteratureUpdateRequest request);

    /**
     * 删除文献
     */
    void deleteLiterature(Long literatureId);

    /**
     * 获取推荐文献
     */
    List<AiXLiteratureResponse> getRecommendedLiteratures(Integer limit, String userId);

    /**
     * 获取热门文献
     */
    List<AiXLiteratureResponse> getPopularLiteratures(Integer limit, String userId);

    /**
     * 搜索文献
     */
    IPage<AiXLiteratureResponse> searchLiteratures(String query, String searchType, Integer page, Integer size, String userId);

    /**
     * 获取文献标签（替代分类）
     */
    List<String> getAllLiteratureTags(Long areaId);

    /**
     * 收藏文献
     */
    void favoriteLiterature(Long literatureId, String userId);

    /**
     * 取消收藏文献
     */
    void unfavoriteLiterature(Long literatureId, String userId);

    /**
     * 获取收藏文献列表
     */
    IPage<AiXLiteratureResponse> getFavoriteLiteratures(Integer page, Integer size, String userId);

    /**
     * 获取文献PDF下载URL
     */
    String getLiteraturePdfUrl(Long literatureId, String userId);

    /**
     * 增加查看次数
     */
    void incrementViewCount(Long literatureId);

    /**
     * 增加下载次数
     */
    void incrementDownloadCount(Long literatureId);
    
    /**
     * 更新文献封面
     */
    R updateLiteratureCover(Long literatureId, MultipartFile coverFile);

    /**
     * 获取文献最常用的8个标签
     */
    List<String> getLiteratureTags(Long areaId);
} 